Micron Document
πŸŽ–οΈGitΠ―Ρ€Π°πŸŽ–οΈ

Node / meshtastic / Meshtastic-Android / files / core / takserver / src / commonMain / kotlin / org / meshtastic / core / takserver / TAKDataPackageGenerator.kt

Displaying Raw β€’ Download

core/takserver/src/commonMain/kotlin/org/meshtastic/core/takserver/TAKDataPackageGenerator.kt renovate/net.java.dev.jna-jna-5.x (5a8f4966) Text, 9.63 KB

T8b949e/*
* Copyright (c) 2026 Meshtastic LLC
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
Tf0883e@fileTb4b4b4:Te6edf3SuppressTb4b4b4(Ta5d6ff"Ta5d6ffLongMethodTa5d6ff"Tb4b4b4)

Tff7b72package T7ee787org.meshtastic.core.takserver

Tff7b72import T7ee787nl.adaptivity.xmlutil.XmlDeclMode
Tff7b72import T7ee787nl.adaptivity.xmlutil.serialization.XML
Tff7b72import T7ee787kotlin.uuid.Uuid

T8b949e/**
* Generates TAK data packages (.zip) compatible with ATAK/iTAK/WinTAK import.
*
* The data package follows the MissionPackageManifest v2 format:
* ```
* Meshtastic_TAK_Server.zip
* β”œβ”€β”€ meshtastic-server.pref (ATAK connection preferences)
* β”œβ”€β”€ truststore.p12 (server cert β€” matches iOS "truststore.p12")
* β”œβ”€β”€ client.p12 (client identity for mTLS)
* └── manifest.xml (MissionPackageManifest v2)
* ```
*
* The bundled certificates / password match Meshtastic-Apple so a single exported package works on both ATAK (Android)
* and iTAK (iOS) without reconfiguration.
*
* Override [bundledCertBytesProvider] in tests to avoid touching the real classpath resources. In production the
* default reads from [TakCertLoader].
*/
Tff7b72object T56d364TAKDataPackageGenerator Tb4b4b4{
Tff7b72private Tff7b72const Tff7b72val Te6edf3PREF_FILE_NAME Tff7b72= Ta5d6ff"Ta5d6ffmeshtastic-server.prefTa5d6ff"
Tff7b72private Tff7b72const Tff7b72val Te6edf3TRUSTSTORE_FILE_NAME Tff7b72= Ta5d6ff"Ta5d6fftruststore.p12Ta5d6ff"
Tff7b72private Tff7b72const Tff7b72val Te6edf3CLIENT_P12_FILE_NAME Tff7b72= Ta5d6ff"Ta5d6ffclient.p12Ta5d6ff"
Tff7b72private Tff7b72const Tff7b72val Te6edf3PACKAGE_NAME Tff7b72= Ta5d6ff"Ta5d6ffMeshtastic_TAK_ServerTa5d6ff"

Tff7b72private Tff7b72val Te6edf3xmlSerializer Tff7b72= Te6edf3XML Tb4b4b4{
Te6edf3xmlDeclMode Tff7b72= Te6edf3XmlDeclModeTb4b4b4.Te6edf3Charset
Te6edf3indentString Tff7b72= Ta5d6ff"Ta5d6ff Ta5d6ff"
Tb4b4b4}

T8b949e/**
* Platform-specific hook for reading the bundled TLS certificate bytes. Default implementation lives in
* `jvmAndroidMain` and reads them from classpath resources via [TakCertLoader].
*/
Tff7b72var Te6edf3bundledCertBytesProviderTb4b4b4: Te6edf3BundledCertBytesProvider Tff7b72= Te6edf3DefaultBundledCertBytesProvider

T8b949e/**
* Generate a complete TAK data package zip.
*
* @param useTls when true, package includes `truststore.p12` + `client.p12` and the pref file uses `ssl`; when
* false, package is TCP-only (legacy).
* @return zip file contents as a [ByteArray]
*/
Tff7b72fun Td2a8ffgenerateDataPackageTb4b4b4(
Te6edf3serverHostTb4b4b4: Tffa657String Tff7b72= Ta5d6ff"Ta5d6ff127.0.0.1Ta5d6ff"Tb4b4b4,
Te6edf3portTb4b4b4: Tffa657Int Tff7b72= Te6edf3DEFAULT_TAK_PORTTb4b4b4,
Te6edf3useTlsTb4b4b4: Tffa657Boolean Tff7b72= Tff7b72trueTb4b4b4,
Te6edf3descriptionTb4b4b4: Tffa657String Tff7b72= Ta5d6ff"Ta5d6ffMeshtastic TAK ServerTa5d6ff"Tb4b4b4,
Tb4b4b4)Tb4b4b4: Te6edf3ByteArray Tb4b4b4{
Tff7b72val Te6edf3prefContent Tff7b72= Te6edf3generateConfigPrefTb4b4b4(Te6edf3serverHostTb4b4b4, Te6edf3portTb4b4b4, Te6edf3useTlsTb4b4b4, Te6edf3descriptionTb4b4b4)
Tff7b72val Te6edf3manifestContent Tff7b72=
Te6edf3generateManifestTb4b4b4(Te6edf3uid Tff7b72= Te6edf3UuidTb4b4b4.Te6edf3randomTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3toStringTb4b4b4(Tb4b4b4)Tb4b4b4, Te6edf3description Tff7b72= Te6edf3descriptionTb4b4b4, Te6edf3useTls Tff7b72= Te6edf3useTlsTb4b4b4)

Tff7b72val Te6edf3entries Tff7b72= Te6edf3mutableMapOfTff7b72<Tffa657StringTb4b4b4, Te6edf3ByteArrayTff7b72>Tb4b4b4(Tb4b4b4)
Te6edf3entriesTff7b72[Te6edf3PREF_FILE_NAMETff7b72] Tff7b72= Te6edf3prefContentTb4b4b4.Te6edf3encodeToByteArrayTb4b4b4(Tb4b4b4)
Te6edf3entriesTff7b72[Ta5d6ff"Ta5d6ffmanifest.xmlTa5d6ff"Tff7b72] Tff7b72= Te6edf3manifestContentTb4b4b4.Te6edf3encodeToByteArrayTb4b4b4(Tb4b4b4)

Tff7b72if Tb4b4b4(Te6edf3useTlsTb4b4b4) Tb4b4b4{
Te6edf3bundledCertBytesProviderTb4b4b4.Te6edf3serverP12BytesTb4b4b4(Tb4b4b4)Tff7b72?.Te6edf3let Tb4b4b4{ Te6edf3entriesTff7b72[Te6edf3TRUSTSTORE_FILE_NAMETff7b72] Tff7b72= Tffa657it Tb4b4b4}
Te6edf3bundledCertBytesProviderTb4b4b4.Te6edf3clientP12BytesTb4b4b4(Tb4b4b4)Tff7b72?.Te6edf3let Tb4b4b4{ Te6edf3entriesTff7b72[Te6edf3CLIENT_P12_FILE_NAMETff7b72] Tff7b72= Tffa657it Tb4b4b4}
Tb4b4b4}

Tff7b72return Te6edf3ZipArchiverTb4b4b4.Te6edf3createZipTb4b4b4(Te6edf3entriesTb4b4b4)
Tb4b4b4}

Tff7b72internal Tff7b72fun Td2a8ffgenerateConfigPrefTb4b4b4(
Te6edf3serverHostTb4b4b4: Tffa657String Tff7b72= Ta5d6ff"Ta5d6ff127.0.0.1Ta5d6ff"Tb4b4b4,
Te6edf3portTb4b4b4: Tffa657Int Tff7b72= Te6edf3DEFAULT_TAK_PORTTb4b4b4,
Te6edf3useTlsTb4b4b4: Tffa657Boolean Tff7b72= Tff7b72trueTb4b4b4,
Te6edf3descriptionTb4b4b4: Tffa657String Tff7b72= Ta5d6ff"Ta5d6ffMeshtastic TAK ServerTa5d6ff"Tb4b4b4,
Tb4b4b4)Tb4b4b4: Tffa657String Tb4b4b4{
Tff7b72val Te6edf3protocolType Tff7b72= Tff7b72if Tb4b4b4(Te6edf3useTlsTb4b4b4) Ta5d6ff"Ta5d6ffsslTa5d6ff" Tff7b72else Ta5d6ff"Ta5d6fftcpTa5d6ff"
Tff7b72val Te6edf3prefs Tff7b72=
Tff7b72if Tb4b4b4(Te6edf3useTlsTb4b4b4) Tb4b4b4{
T8b949e// TLS / mTLS mode β€” matches the iOS data package format exactly.
Te6edf3TAKPreferencesXmlTb4b4b4(
Te6edf3preferences Tff7b72=
Te6edf3listOfTb4b4b4(
Te6edf3TAKPreferenceXmlTb4b4b4(
Te6edf3version Tff7b72= Ta5d6ff"Ta5d6ff1Ta5d6ff"Tb4b4b4,
Te6edf3name Tff7b72= Ta5d6ff"Ta5d6ffcot_streamsTa5d6ff"Tb4b4b4,
Te6edf3entries Tff7b72=
Te6edf3listOfTb4b4b4(
Te6edf3TAKEntryXmlTb4b4b4(Ta5d6ff"Ta5d6ffcountTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffclass java.lang.IntegerTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ff1Ta5d6ff"Tb4b4b4)Tb4b4b4,
Te6edf3TAKEntryXmlTb4b4b4(Ta5d6ff"Ta5d6ffdescription0Ta5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffclass java.lang.StringTa5d6ff"Tb4b4b4, Te6edf3descriptionTb4b4b4)Tb4b4b4,
Te6edf3TAKEntryXmlTb4b4b4(Ta5d6ff"Ta5d6ffenabled0Ta5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffclass java.lang.BooleanTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6fftrueTa5d6ff"Tb4b4b4)Tb4b4b4,
Te6edf3TAKEntryXmlTb4b4b4(
Ta5d6ff"Ta5d6ffconnectString0Ta5d6ff"Tb4b4b4,
Ta5d6ff"Ta5d6ffclass java.lang.StringTa5d6ff"Tb4b4b4,
Ta5d6ff"Tffd700$Te6edf3serverHostTa5d6ff:Tffd700$Te6edf3portTa5d6ff:Tffd700$Te6edf3protocolTypeTa5d6ff"Tb4b4b4,
Tb4b4b4)Tb4b4b4,
Tb4b4b4)Tb4b4b4,
Tb4b4b4)Tb4b4b4,
Te6edf3TAKPreferenceXmlTb4b4b4(
Te6edf3version Tff7b72= Ta5d6ff"Ta5d6ff1Ta5d6ff"Tb4b4b4,
Te6edf3name Tff7b72= Ta5d6ff"Ta5d6ffcom.atakmap.app_preferencesTa5d6ff"Tb4b4b4,
Te6edf3entries Tff7b72=
Te6edf3listOfTb4b4b4(
Te6edf3TAKEntryXmlTb4b4b4(Ta5d6ff"Ta5d6ffdisplayServerConnectionWidgetTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffclass java.lang.BooleanTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6fftrueTa5d6ff"Tb4b4b4)Tb4b4b4,
Te6edf3TAKEntryXmlTb4b4b4(
Ta5d6ff"Ta5d6ffcaLocationTa5d6ff"Tb4b4b4,
Ta5d6ff"Ta5d6ffclass java.lang.StringTa5d6ff"Tb4b4b4,
Ta5d6ff"Ta5d6ffcert/Tffd700$Te6edf3TRUSTSTORE_FILE_NAMETa5d6ff"Tb4b4b4,
Tb4b4b4)Tb4b4b4,
Te6edf3TAKEntryXmlTb4b4b4(Ta5d6ff"Ta5d6ffcaPasswordTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffclass java.lang.StringTa5d6ff"Tb4b4b4, Te6edf3TAK_BUNDLED_CERT_PASSWORDTb4b4b4)Tb4b4b4,
Te6edf3TAKEntryXmlTb4b4b4(
Ta5d6ff"Ta5d6ffcertificateLocationTa5d6ff"Tb4b4b4,
Ta5d6ff"Ta5d6ffclass java.lang.StringTa5d6ff"Tb4b4b4,
Ta5d6ff"Ta5d6ffcert/Tffd700$Te6edf3CLIENT_P12_FILE_NAMETa5d6ff"Tb4b4b4,
Tb4b4b4)Tb4b4b4,
Te6edf3TAKEntryXmlTb4b4b4(
Ta5d6ff"Ta5d6ffclientPasswordTa5d6ff"Tb4b4b4,
Ta5d6ff"Ta5d6ffclass java.lang.StringTa5d6ff"Tb4b4b4,
Te6edf3TAK_BUNDLED_CERT_PASSWORDTb4b4b4,
Tb4b4b4)Tb4b4b4,
Tb4b4b4)Tb4b4b4,
Tb4b4b4)Tb4b4b4,
Tb4b4b4)Tb4b4b4,
Tb4b4b4)
Tb4b4b4} Tff7b72else Tb4b4b4{
T8b949e// Legacy plain-TCP mode (not used in production, kept for tests / fallback)
Te6edf3TAKPreferencesXmlTb4b4b4(
Te6edf3preferences Tff7b72=
Te6edf3listOfTb4b4b4(
Te6edf3TAKPreferenceXmlTb4b4b4(
Te6edf3version Tff7b72= Ta5d6ff"Ta5d6ff1Ta5d6ff"Tb4b4b4,
Te6edf3name Tff7b72= Ta5d6ff"Ta5d6ffcot_streamsTa5d6ff"Tb4b4b4,
Te6edf3entries Tff7b72=
Te6edf3listOfTb4b4b4(
Te6edf3TAKEntryXmlTb4b4b4(Ta5d6ff"Ta5d6ffcountTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffclass java.lang.IntegerTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ff1Ta5d6ff"Tb4b4b4)Tb4b4b4,
Te6edf3TAKEntryXmlTb4b4b4(Ta5d6ff"Ta5d6ffdescription0Ta5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffclass java.lang.StringTa5d6ff"Tb4b4b4, Te6edf3descriptionTb4b4b4)Tb4b4b4,
Te6edf3TAKEntryXmlTb4b4b4(Ta5d6ff"Ta5d6ffenabled0Ta5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffclass java.lang.BooleanTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6fftrueTa5d6ff"Tb4b4b4)Tb4b4b4,
Te6edf3TAKEntryXmlTb4b4b4(
Ta5d6ff"Ta5d6ffconnectString0Ta5d6ff"Tb4b4b4,
Ta5d6ff"Ta5d6ffclass java.lang.StringTa5d6ff"Tb4b4b4,
Ta5d6ff"Tffd700$Te6edf3serverHostTa5d6ff:Tffd700$Te6edf3portTa5d6ff:Tffd700$Te6edf3protocolTypeTa5d6ff"Tb4b4b4,
Tb4b4b4)Tb4b4b4,
Tb4b4b4)Tb4b4b4,
Tb4b4b4)Tb4b4b4,
Te6edf3TAKPreferenceXmlTb4b4b4(
Te6edf3version Tff7b72= Ta5d6ff"Ta5d6ff1Ta5d6ff"Tb4b4b4,
Te6edf3name Tff7b72= Ta5d6ff"Ta5d6ffcom.atakmap.app_preferencesTa5d6ff"Tb4b4b4,
Te6edf3entries Tff7b72=
Te6edf3listOfTb4b4b4(
Te6edf3TAKEntryXmlTb4b4b4(Ta5d6ff"Ta5d6ffdisplayServerConnectionWidgetTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffclass java.lang.BooleanTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6fftrueTa5d6ff"Tb4b4b4)Tb4b4b4,
Tb4b4b4)Tb4b4b4,
Tb4b4b4)Tb4b4b4,
Tb4b4b4)Tb4b4b4,
Tb4b4b4)
Tb4b4b4}

Tff7b72return Te6edf3xmlSerializer
Tb4b4b4.Te6edf3encodeToStringTb4b4b4(Te6edf3TAKPreferencesXmlTb4b4b4.Te6edf3serializerTb4b4b4(Tb4b4b4)Tb4b4b4, Te6edf3prefsTb4b4b4)
Tb4b4b4.Te6edf3replaceTb4b4b4(
Ta5d6ff"Ta5d6ff<?xml version=Ta5d6ff\"Ta5d6ff1.0Ta5d6ff\"Ta5d6ff encoding=Ta5d6ff\"Ta5d6ffUTF-8Ta5d6ff\"Ta5d6ff?>Ta5d6ff"Tb4b4b4,
Ta5d6ff"Ta5d6ff<?xml version='1.0' encoding='ASCII' standalone='yes'?>Ta5d6ff"Tb4b4b4,
Tb4b4b4)
Tb4b4b4}

Tff7b72internal Tff7b72fun Td2a8ffgenerateManifestTb4b4b4(
Te6edf3uidTb4b4b4: Tffa657StringTb4b4b4,
Te6edf3descriptionTb4b4b4: Tffa657String Tff7b72= Ta5d6ff"Ta5d6ffMeshtastic TAK ServerTa5d6ff"Tb4b4b4,
Te6edf3useTlsTb4b4b4: Tffa657Boolean Tff7b72= Tff7b72trueTb4b4b4,
Tb4b4b4)Tb4b4b4: Tffa657String Tff7b72= Te6edf3buildString Tb4b4b4{
Te6edf3appendLineTb4b4b4(Ta5d6ff"""Ta5d6ff<MissionPackageManifest version=Ta5d6ff"Ta5d6ff2Ta5d6ff"Ta5d6ff>Ta5d6ff"""Tb4b4b4)
Te6edf3appendLineTb4b4b4(Ta5d6ff"Ta5d6ff <Configuration>Ta5d6ff"Tb4b4b4)
Te6edf3appendLineTb4b4b4(Ta5d6ff"""Ta5d6ff <Parameter name=Ta5d6ff"Ta5d6ffuidTa5d6ff"Ta5d6ff value=Ta5d6ff"Tffd700${Te6edf3descriptionTb4b4b4.Te6edf3xmlEscapedTb4b4b4(Tb4b4b4)Tffd700}Ta5d6ff.Tffd700$Te6edf3uidTa5d6ff"Ta5d6ff/>Ta5d6ff"""Tb4b4b4)
Te6edf3appendLineTb4b4b4(Ta5d6ff"""Ta5d6ff <Parameter name=Ta5d6ff"Ta5d6ffnameTa5d6ff"Ta5d6ff value=Ta5d6ff"Tffd700$Te6edf3PACKAGE_NAMETa5d6ff"Ta5d6ff/>Ta5d6ff"""Tb4b4b4)
Te6edf3appendLineTb4b4b4(Ta5d6ff"""Ta5d6ff <Parameter name=Ta5d6ff"Ta5d6ffonReceiveDeleteTa5d6ff"Ta5d6ff value=Ta5d6ff"Ta5d6fftrueTa5d6ff"Ta5d6ff/>Ta5d6ff"""Tb4b4b4)
Te6edf3appendLineTb4b4b4(Ta5d6ff"Ta5d6ff </Configuration>Ta5d6ff"Tb4b4b4)
Te6edf3appendLineTb4b4b4(Ta5d6ff"Ta5d6ff <Contents>Ta5d6ff"Tb4b4b4)
Te6edf3appendLineTb4b4b4(Ta5d6ff"""Ta5d6ff <Content ignore=Ta5d6ff"Ta5d6fffalseTa5d6ff"Ta5d6ff zipEntry=Ta5d6ff"Tffd700$Te6edf3PREF_FILE_NAMETa5d6ff"Ta5d6ff/>Ta5d6ff"""Tb4b4b4)
Tff7b72if Tb4b4b4(Te6edf3useTlsTb4b4b4) Tb4b4b4{
Te6edf3appendLineTb4b4b4(Ta5d6ff"""Ta5d6ff <Content ignore=Ta5d6ff"Ta5d6fffalseTa5d6ff"Ta5d6ff zipEntry=Ta5d6ff"Tffd700$Te6edf3TRUSTSTORE_FILE_NAMETa5d6ff"Ta5d6ff/>Ta5d6ff"""Tb4b4b4)
Te6edf3appendLineTb4b4b4(Ta5d6ff"""Ta5d6ff <Content ignore=Ta5d6ff"Ta5d6fffalseTa5d6ff"Ta5d6ff zipEntry=Ta5d6ff"Tffd700$Te6edf3CLIENT_P12_FILE_NAMETa5d6ff"Ta5d6ff/>Ta5d6ff"""Tb4b4b4)
Tb4b4b4}
Te6edf3appendLineTb4b4b4(Ta5d6ff"Ta5d6ff </Contents>Ta5d6ff"Tb4b4b4)
Te6edf3appendTb4b4b4(Ta5d6ff"Ta5d6ff</MissionPackageManifest>Ta5d6ff"Tb4b4b4)
Tb4b4b4}
Tb4b4b4}

T8b949e/**
* Supplies the bundled server / client PKCS#12 bytes for [TAKDataPackageGenerator]. Platform implementations live in
* `jvmAndroidMain`.
*/
Tff7b72interface T56d364BundledCertBytesProvider Tb4b4b4{
Tff7b72fun Td2a8ffserverP12BytesTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3ByteArray?

Tff7b72fun Td2a8ffclientP12BytesTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3ByteArray?
Tb4b4b4}

T8b949e/**
* Default provider that returns `null` on platforms without a real implementation. Overridden at startup on JVM /
* Android by pointing [TAKDataPackageGenerator.bundledCertBytesProvider] at [TakCertLoader].
*/
Tff7b72private Tff7b72object T56d364DefaultBundledCertBytesProvider Tb4b4b4: Te6edf3BundledCertBytesProvider Tb4b4b4{
Tff7b72override Tff7b72fun Td2a8ffserverP12BytesTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3ByteArray? Tff7b72= Tff7b72null

Tff7b72override Tff7b72fun Td2a8ffclientP12BytesTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3ByteArray? Tff7b72= Tff7b72null
Tb4b4b4}

Served by rngit 1.5.0 - Generated in 0.07s